跳到主要内容

获取合同短链接 FAQ

返回合同签署、填写、查看链接,可用于短信、邮件或嵌入网页,便于在业务系统中完成合同签署相关操作。


如何生成合同短链接?

通过调用 GET /resrun-paas/kaifangqian/openAPI/V2/contract/pageUrl 接口,提供必要的参数即可生成合同短链接。主要参数包括:

  • contractId:合同ID(必填)
  • contact:办理人账号(必填)
  • taskId:任务ID(可选)
  • noLogin:是否免登录(可选)
  • pageUrlExpireTime:免登录失效时间(可选)

免登录链接有哪些限制条件?

  1. 办理人必须已在电子签章平台注册账号
  2. 办理人必须拥有对应合同的待办任务身份
  3. 免登录失效时间默认为72小时(可自定义)
  4. 过期后需重新获取链接或登录验证

如何设置同步回调地址?

在返回的短链接后拼接编码后的callbackPage参数:

https://home.kaifangqian.com/#/contract/detail/base?code=PxfgSHB1&callbackPage=https%3A%2F%2Fbaidu.com%3Fcode%3D001

其中callbackPage的值需要进行URL编码。


参数contact的注意事项?

  1. 必须使用实际办理人的账号(邮箱/手机号)
  2. 不同身份使用不同账号:
    • 发起人 → 发起人账号
    • 签署人 → 签署人账号
    • 抄送人 → 抄送人账号

禁止使用发起人账号获取其他签署人的链接(防止越权)


免登录失效时间格式要求?

格式必须为:YYYY-MM-DD HH:MM:SS
示例:2025-12-31 23:59:59
注意:时间必须晚于当前时间


链接免登录过期后如何处理?

  1. 重新调用接口获取新链接
  2. noLogin=1时设置新的pageUrlExpireTime
  3. 使用非免登录方式让用户自行登录

服务热线
15010993257